home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dirut / rm_om.zip / RM.MAN < prev    next >
Text File  |  1991-10-16  |  3KB  |  73 lines
  1. rm                MS-DOS programmers manual        rm
  2.  
  3.     rm [//afir] [filename] [-] {...}
  4.  
  5.     Removes files, directories or recursively directory structures given as
  6.     argument.  If the a option argument contains a second option separator
  7.     (by default '/'), all the following arguments are interpreted as file
  8.     names, even if they have a leading '/'.
  9.  
  10.     If the argument "-" is given, stdin is read at that point to get filenames
  11.     to be removed.  Generally this is not needed, because the last argument is
  12.     always assumed to be "-" if stdin is not a tty.  Option settings cannot be
  13.     read from stdin.
  14.  
  15.     If the environment variable RMFLAGS is set, it is first parsed as initial
  16.     options for rm.  If, for example, you feel that all file deletes should
  17.     be inquired, do:
  18.     SET RMFLAGS=I
  19.     Note that if this variable contains the option separator character, no
  20.     options can be specified on the command line.  The setting:
  21.     SET RMFLAGS=/FA
  22.     Will prevent options being set on the command line and force F and A modes
  23.     permanently on.
  24.  
  25.     Please note that by changing SWITCHAR in the config.sys file, the option
  26.     separator character (default '/') may be changed.  This program will also
  27.     react to this change, in spite of command.com not changing it's workings
  28.     (on DOS 3.10 and higher).
  29.     There are some problems with using SWITCHAR (not the least being that in
  30.     DOS5 it's been totally removed), so another solution is to set the first
  31.     character of the environment variable SWITCHAR to the value you wish.
  32.     For example, to achieve more Unix-likeness:
  33.     SET SWITCHAR=-
  34.  
  35.     Options:
  36.     a   all files/directories are rm'd, also readonly/hidden/system.  If
  37.         this argument is not specified, these files are ignored and dir's
  38.         containing these files will not be removed.  If f option is not
  39.         specified with this, rm will be asked for each file.
  40.     f   force, don't display error messages even if errors are detected.
  41.         Also don't ask when removing readonly/hidden/system files/dirs.
  42.     i   inquire yes/no/all/quit for each file.
  43.     q   quiet mode, don't display file names as they are removed.
  44.     r   recursive rm.  The argument(s) must be non-wildcard(s) specifying
  45.         the directory system to remove.
  46.  
  47.     Diagnostics:
  48.     usage: rm [//afir] {filename}...
  49.         Usage information, given if no valid file arguments
  50.     unknown option %s in env. variable RMFLAGS
  51.     Options given in environment variable RMFLAGS were not valid
  52.     unknown option %s
  53.         Option given was not valid (also the usage message is given)
  54.     no match for %s
  55.         The wildcard pattern shown did not match anything
  56.     rm %s ?
  57.     The program is asking for confirmation remove the shown item;
  58.     press Y to remove, N not to and Q to quit
  59.     rm: %s
  60.     The program confirms that the shown item was removed
  61.     override mode %02x for %s ?
  62.     The shown item was readonly/system/hidden, and the program asks
  63.     for confirmation if to delete the file
  64.     cannot chmod "%s" from %02x (status %d)
  65.     cannot rmdir "%s" (status %d)
  66.     cannot remove "%s" (status %d)
  67.     The specified operation could not be performed, see MS-DOS manual
  68.     for explanation of status codes
  69.  
  70. (c) 1988,1989,1990,1991 by Otto Makela, Jyvaskyla, Finland
  71. Distributed under the GNU General Licence -- see file COPYING for details
  72. Call JyBox +358 41 211 562, V.22bis/V.22/V.21, 24h/day
  73.